-------------------------------------------------------------------------- 勤労５号（ＭｕＳＩＣＡ互換ドライバ）　公式規格書 著　者：黒田　圭一 発表者：ＢＴＯ（ＭｕＳＩＣＡ研究所） (C) 1996,1997 Keiichi Kuroda / BTO(MuSICA Laboratory) All rights reserved. -------------------------------------------------------------------------- -------- ☆初めに -------- 　この文章は汎用性を持って製作した（つもりの）勤労５号の機能を説明するもの ですが、アセンブラでプログラムすることを前提に書いていますので、アセンブラ の知識が必要です（ＢＡＳＩＣのみでは勤労５号は使用できません）。 　それでは、少しずつ解説をしていきたいと思います。 　ちなみにお断りですが、勤労５号は私の技術不足や怠惰な性格のため、いろいろ と不安定な部分もありますが、これも少しずつ直していきたいと思っていますが、 もしいきなり動作が止まっても、ご了承ください（すいません）。 ---------------- ☆勤労５号の特徴 ---------------- 　勤労５号の特徴として以下のものがあります。 ・ＳＣＣゲームカートリッジ・似非ＳＣＣラム等もＳＣＣ音源のカートリッジとし 　て認識。 ・新設命令として、チャンネル単位でマスターボリュームを設定できたり、フェー 　ドアウトといった機能を増設。 ・ＭｕＳＩＣＡ解析家として、ＭｕＳＩＣＡ解析して見つかった細かいバグを訂正 　（例えば、ＭＭＬのＷをちゃんと使えるものとしたり） 　ただし、変更することによって不都合が起る部分は無修正です。 　（例えば、Ｑ設定が変なところ） ・「勤労規格」と称した規格を制定し、コンパイラ（勤労４号）と同時に対応 -------------------- ☆勤労５号のアドレス -------------------- 　勤労５号は６０００Ｈから置くことによって使えます。 　ただし、ドライバのファイル形式がＢＳＡＶＥ形式と同じなので、プログラムの 前に７バイト分付いています。なお、ＢＳＡＶＥのヘッダー部分には開始アドレス を００００Ｈとしています。 　ＢＳＡＶＥのヘッダーが付いていることに気を付けてください。 -------------------------- ☆勤労５号のバージョン番号 -------------------------- 　勤労５号のバージョンを得たい場合は６００ＥＨにバージョンの整数部分が、６ ００ＦＨにバージョンの小数部分がＢＣＤ形式に入っています。 　例を出しますと、バージョンが１．２３でしたら、６００ＥＨに”０１Ｈ”、６ ００ＦＨに”２３Ｈ”と入っています。 ---------------------------- ☆勤労５号の公開ワークエリア ---------------------------- 　勤労５号では以下のワークエリアをユーザーに公開しています。 ・ＦＭＳＬＴ （６０１０Ｈ） ＦＭ音源のスロット番号です。無い場合は０が入っています。 ・ＳＣＣＳＬＴ （６０１１Ｈ） ＳＣＣ音源のスロット番号です。無い場合は０が入っています。 　なお、上記のワークエリアを書き換える事は非演奏時に限って行ってください。 　また、ＳＣＣスロットはイニシャライズの時のみチェックしていますので、後差 しなどをして初期化前にＳＣＣを後から付けた場合はここに書いているＳＣＣＳＬ Ｔにそのスロット番号を入れておいてください。 　なお、音源スロットを間違って指定した場合の動作の保証はありませんので、気 を付けてください。 -------------------------- ☆勤労５号の公開エントリー -------------------------- 　勤労５号では以下のエントリーをユーザーに公開しています。 ・ＩＮＩＴＡＬ （６０２０Ｈ） 　入力レジスタ：無し 　出力レジスタ：無し 　破壊レジスタ：すべて 　割り込み状態：割り込み禁止 ※割り込み状態とは、エントリーをコールした後に割り込み状態の変化があるのか 　を書いています。 ＜機能＞ 　勤労５号のイニシャライズです。以下のエントリーを使用するときはからなずコ ールしてください。 　なお、ここでＦＭ音源およびＳＣＣのサーチをしています。 　ＳＣＣをこの初期化した後に後差しした場合は前述の通り、ワークエリアを書き 換えてください。 ・ＭＰＬＡＹ１ （６０２３Ｈ） 　入力レジスタ：ＨＬ ＢＧＭデータの先頭アドレス Ａ 繰り返し回数（０で永久ループ） 　出力レジスタ：Ｃﾌﾗｸﾞ 演奏に失敗した時に１、成功した時０ 　破壊レジスタ：すべて 　割り込み状態：割り込み禁止 ＜機能＞ 　ＢＧＭを演奏します。ＢＧＭデータはコンパイルに指定した時と同じアドレスに 置いてください。 　なお、バ−ジョン１．００から演奏の成功・失敗を知ることができます（ＭｕＳ ＩＣＡもしくは勤労規格のＢＧＭファイルのチェックを入れています）。 ・ＭＰＬＡＹ２ （６０２６Ｈ） 　入力レジスタ：ＨＬ ＢＧＭデータの置いている先頭アドレス ＤＥ ＢＧＭデータコンパイル時に指定したアドレス Ａ 繰り返し回数（０で永久ループ） 　出力レジスタ：Ｃﾌﾗｸﾞ 演奏に失敗した時に１、成功した時０ 　割り込み状態：割り込み禁止 ＜機能＞ 　ＢＧＭを演奏します。ＭＰＬＡＹ１と違う点はＢＧＭデータをどこのアドレスに 置いても、置いたアドレスとコンパイル時のアドレスをセットすれば、内部で処理 をして、きっちりと演奏するという点です。 　なお、コンパイル時に指定したアドレスはＢＧＭファイルがＢＳＡＶＥ形式と同 じですから、そのヘッダーから得られます。 　なお、このバージョン１．００から演奏の失敗・成功が知ることができます（Ｍ ｕＳＩＣＡもしくは勤労規格のＢＧＭファイルのチェックを入れています）。 ・ＭＩＮＴＥＲ （６０２９Ｈ） 　入力レジスタ：無し 　出力レジスタ：無し 　破壊レジスタ：すべて 　割り込み状態：割り込み許可 ＜機能＞ 　演奏のための１／６０秒割り込み処理をします。ＭＰＬＡＹ１やＭＰＬＡＹ２な どをコールしてから、割り込み処理からここにコールできるようにフックの書き換 え等を行ってください。 ・ＭＳＴＯＰ （６０２ＣＨ） 　入力レジスタ：無し 　出力レジスタ：無し 　破壊レジスタ：すべて 　割り込み状態：割り込み許可 ＜機能＞ 　演奏を終了します。 　なお、ここをコールしてから、割り込みフックを元に戻してください。 ・ＦＡＤＯＵＴ　（６０２ＦＨ） 　入力レジスタ：Ａ （フェードアウトの速さ（１〜６３）） 　出力レジスタ：無し 　破壊レジスタ：無し 　割り込み状態：割り込み禁止 ＜機能＞ 　フェードアウトして演奏を終了します。Ａレジスタに入る数値は小さいほど、フ ェードアウトスピードが速くなります。 　なお、ここをコールしてから、後述の演奏フラグチェックのエントリーをコール して、演奏が完了したことを確認してから、割り込みフックを元に戻してください。 　なお、ＭＭＬのUおよびHで発生する音はフェードアウトしません（当たり前）。 ・ＰＬＹＣＨＫ（６０３２Ｈ） 　入力レジスタ：無し 　出力レジスタ：Ａ ビット０が１で曲を演奏中 ビット１が１でポーズは掛かっていない ＨＬ 現在の演奏回数 　破壊レジスタ：すべて 　割り込み状態：不変 ＜機能＞ 　様々な演奏状態を得ます。 　まず。Ａレジスタですが、ポーズされていても演奏中であるかだけを調べるだけ でしたら、このレジスタが０であるか否かだけをチェックすればいいです。 　なお、ビット０はポーズ中でも１になっていますので、演奏中ということになっ ています。 　そして、ＨＬですが、最初は１から始まって、６５５３５になった次は０に戻っ てしまいます。 　ですから、ミュージックプレイヤーを製作されている人で１回だけ演奏して、２ 回目はフェードアウトして消えるとかいう事をしたい場合はＨＬが２になったら、 フェードアウトさせたらＯＫです（ＭｕＰＬＡＹでも似たことをしています）。 ・ＰＡＵＲＥＰ（６０３５Ｈ） 　入力レジスタ：無し 　出力レジスタ：無し 　破壊レジスタ：すべて 　割り込み状態：割り込み禁止 ＜機能＞ 　ここを呼ぶ度にポーズ・リプレイが切り変わります。 　なお、演奏開始した時は前の演奏でポーズ状態で演奏を停止しても、ポーズ状態 はキャンセルされています。 ・ＡＬＬＭＶＯ（６０３８Ｈ） 　入力レジスタ：Ａ マスターボリューム値（０〜１５） 　出力レジスタ：無し 　破壊レジスタ：すべて 　割り込み状態：割り込み禁止（ただし、成功時） ＜機能＞ 　マスターボリュームを全チャンネル変えます。 　Ａレジスタに入れる数値は小さい程、音量が大きくなります。 　なお、デフォルトは０で、範囲を越えた数値を入れた場合は何もせず戻ってきま す（そのときの割り込み状態は不変です）。 ・ＰＡＴＭＶＯ（６０３ＢＨ） 　入力レジスタ：Ａ マスターボリューム値（０〜１５） Ｃ 変えたいチャンネル（０〜１６） 　出力レジスタ：無し 　破壊レジスタ：すべて 　割り込み状態：割り込み禁止（ただし、成功時） ＜機能＞ 　前述のマスターボリューム値を変えるものの各チャンネル版で、これを使うと各 チャンネルごとに変えることができます。 　ただし、これで設定した後、ＡＬＬＭＶＯで音量を変えた場合はそれで設定した 値になります。要するに、もしこれで各チャンネルごとに同じ音量を設定したいと きに面倒になりますので（１７回コールしないといけませんから）、その手間を省 くために作ったのがＡＬＬＭＶＯです。 　ちなみにチャンネルの番号ですが、ＦＭ音源が０〜８（リズム使用時、リズムは ６）、ＰＳＧ音源が９〜１１、ＳＣＣ音源が１２〜１６となっています。 　なお、ＡおよびＢレジスタの範囲が越えていた場合は何もせずに帰ってきます （そのときの割り込み状態は不変です）。 ・ＰＳＧＯＵＴ（６０３ＥＨ） 　入力レジスタ：Ｂ ＰＳＧ出力のＯＮ（０）／ＯＦＦ（１） ビット０でＰＳＧ１ 　出力レジスタ：無し 　破壊レジスタ：すべて 　割り込み状態：割り込み禁止 ＜機能＞ 　ＰＳＧの出力スイッチです。 　ゲーム中に効果音などを鳴らすとき、演奏でＰＳＧに出力してほしくない場合に 使います。 ・ＣＰＹＲＩＴ（６０４１Ｈ） 　入力レジスタ：無し 　出力レジスタ：ＨＬ 著作権表示用文字列の先頭アドレス 　破壊レジスタ：すべて 　割り込み状態：不変 ＜機能＞ 　勤労５号の著作権表示用文字列をＧＥＴします。 　形式はＭＳＸ−ＤＯＳのＢＤＯＳのファンクションコール０９Ｈで表示させる時 の形式と全く同じですので、終了のマークとして「＄」を使用しています。 　しかし、トップレジスタを返しているレジスタがＨＬレジスタですので、ＤＥレ ジスタに入れて直して、Ｃレジスタに９Ｈを入れて、ＢＤＯＳにコールすればＯＫ です（ただし、勤労５号の入っているスロットが選択されていないとダメです）。 ・ＧＥＴＷＯＫ（６０４４Ｈ） 　入力レジスタ：無し 　出力レジスタ：ＩＸ 各チャンネルのワークエリアの先頭アドレス ＨＬ 上記ワークエリアの１チャンネル当たりのワークエリア の大きさ ＩＹ ＰＳＧ＆ＳＣＣのエンベロープ関連ワークエリアの先頭 アドレス ＤＥ 上記ワークエリアの１チャンネル当たりのワークエリア の大きさ 　破壊レジスタ：すべて 　割り込み状態：不変 ＜機能＞ 　ワークエリアのアドレスなどをＧＥＴすることができます。 　ワークエリアの細部の説明は正直言って無意味ですので、いたしません。 　プレイヤーを製作して、音量や発音情報を知りたいためにワークエリアの参照が どうしても必要な方は黒田まで連絡下さい。 ・ＧＥＴＰＡＲ（６０４７Ｈ） 　入力レジスタ：ＨＬ ＢＧＭデータの置いている先頭アドレス Ｃ 得たいパラメ−タ番号 　出力レジスタ：Ｃﾌﾗｸﾞ １でＢＧＭデータから得られない その他、パラメータ番号によって変化 　破壊レジスタ：すべて 　割り込み状態：不変 ＜機能＞ 　この機能は勤労５号バ−ジョン１．００以降でのみ使えます。 　Ｃレジスタに番号を入れることによって得たいパラメ−タを得ます。 　＊Ｃ＝１の時 　　入力レジスタ：ＨＬ コンパイルした時のアドレス 　　＜説明＞ 　　ＨＬレジスタにコンパイル時に設定したアドレスが入っています。 　＊Ｃ＝２の時 　　入力レジスタ：ＨＬ タイトルの入っている先頭アドレス 　　＜説明＞ 　　ＨＬレジスタの示すアドレスからタイトルが入っています。 　　そのアドレスから００Ｈが入っているアドレスまでが、タイトルです。 　＊Ｃ＝３の時 　　入力レジスタ：ＨＬ メモの入っている先頭アドレス 　　＜解説＞ 　　ＨＬレジスタの示アドレスからメモが入っています。 　　そのアドレスから００Ｈがはいっているアドレスまでが、メモです ・ＧＥＴＦＡＲ（６０４ＡＨ） 　入力レジスタ：なし 　出力レジスタ：なし 　破壊レジスタ：すべて 　割り込み状態：割り込み許可 ＜機能＞ 　勤労ファンファーレ（以後、勤レと略）を演奏します。 　勤レには７種類ありますが、どれが演奏されるかは、一番最初のイニシャライズ の時に、ランダムで決定されます。 ------------------ ☆カラオケについて ------------------ 　勤労規格では、カラオケデータのフォーマットを「Ｐ．Ｙ．Ｆ．」が発表してい るＫＡＲＡＳＹＳ（仮称）に準拠するとします。 　データフォーマットに関しましては、ＫＡＲＡＳＹＳ（仮称）同封の規格書を参 照してください。 -------------- ☆紹介終わって -------------- 　以上が勤労５号の公開ワークエリアおよびエントリーです。 　多分、分かりにくい説明だったと思いますが、こんなもんでご勘弁ください。 　皆様からの質問などからこの文章もよりよいものに仕上がっていくと思います。 ---------- ☆質問など ---------- 　え〜、質問などは私までお手紙ください。 　送る際の手続きの方法は勤労５号のドキュメントを参照してください。 〒５７１ 大阪府　門真市　大倉町　６−３ （おおさかふ　かどまし　おおくらちょう） 黒田　圭一 （くろだ　けいいち） Illusion Net City ID:KURODA ハンドル：黒田　圭一（仮名） Msx N.P ID:KURODA ハンドル：黒田　圭一（仮称） Do-RAGON NET City ID:KURODA ハンドル：黒田　圭一 ray-net ID:RAY081 ハンドル：黒田　圭一（匿名） PP-NET ID:KURODA ハンドル：黒田　圭一（推定） げぬいねっと ID:GENU0076 ハンドル：黒田　圭一（以下略） ＤＤねっと ID:DNET0004 ハンドル：黒田　圭一（偽名） E-mail:kuroda@g-net.org -------- ☆最後に -------- 　え〜、勤労５号の解説はこれくらいにします。 　文章途中にも書きましたが、皆さんからいろいろと質問をしていただけたら、そ ういった部分が分からないという事も分かりますので、その部分の文章の追加など ができて、よりよい規格書ができます。そんな点から、この規格書も下手すれば、 毎日変わっているかもしれません（もちろんよりよくなってです）。 　という訳で、皆さんからのお手紙などをお待ちしています。 　それでは、さようなら ＢＴＯ首謀者・ＢＴＯ　ＭｕＳＩＣＡ研究所研究員 黒田　圭一